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Written by V.B. Hester 

For 

Soft Sector Marketing, Inc. 



D S S 2.1 Version 2.2 

Version 2.2 Boss from Soft Sector 
Marketing Inc. has only cosmeticly been 
changed from Version 2.1. The program now 
runs on Ultra Dos. All instructions are the 
same as in the manual for 2.1 (provided) 
execpt as per this addendum. It now comes 
with a universal lower case driver at no 
extra cost. 

The enclosed lower case driver tape 
runs in any Level II or D.O.S. that has the 
hardware modification to permit lower case. 
This program has been tested with about 8 
different types of lower case hardware mods, 
including the RADIO SHACK MOD and should run 
with no problems. Like the program DOSS €.1 
this program loads to the top of memory r 
under anyother program that is already there 
and resets the memory size to protect it's 
self. 

TO LOAD TAPE TYPE: 
SYSTEM (ENTER) 
*? L (ENTER) 
*? / (ENTER) 

Information to load lower case driver to 

disk. 

starting location 5F00 

ending location 5FAF 

transfer location 5F00 

If this package is on disk then to run 
the program just type LC from DOS READY. 

Once the program is executed your in 
lower case. You must now hold the shift key 
to have a capital letter appear on the 
screen. To lock the ' program in the upper 
case mode hold down the SHIFT key and hit 
the SPACE BAR. To return to lower case, 
reverse the process. 

Last but not least is the new low price 
of $18.95 on cassette and $23.95 on 
diskette. 



DOSS OVERVIEW 



INTRODUCTION 



This utility is designed to aid you in creating and debugging programs written 
in basic. The utility will allow you to trace the program flow, to single step the 
basjc program, to observe the conditions of variables during program 
execution, and to push your basic programs on the stack or pop them off the 
stack during program development The utility is known to operate with the 
following versions of disk operating systems: 

TRSDOS 2.2 2.3 NEWDOS ■ BO 

NEWDOS2.1 VTOS-3.0 

The utility will operate with either Level II Basic or Disk Basic. The minimum 
equipment configuration is a 16K Level il TRS-80 Microcomputer with 
cassette input. The program will automatically relocate itself fo*iarger memory 
machines. 

A brief description of each function is listed below. 

TRACE FUNCTION 

Allows you to follow the twisted (or logical) path your program takes, without 
messiness on the screen caused by the other trace function. 

SINGLE STEPPING 

Allows you to single step individual lines of a basic program of individual 
instructions within a line. 

BREAK POINT 

The trace and single step commands can be invoked by your program while it 
is running with this feature. 

REVIEWING VARIABLES 

Allows you to pause to review selected variables during program execution 
and return to your program with the display restored to that shown before you 
review the variables (great if your screen had graphics displayed). 

STACKING PROGRAMS 

Allows you to stack one or more programs in high memory while you work on 
or run another program. Of course, this ability is limited by the amount of free 
memory space available. You can retrieve the stacked programs at wilL 
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copYRiarr (c) 1980 by v. b. hester 



important notice 



TI1IS "BOSS" COMPUTER PROGRAM IS DISTRIBUTED ON AN "AS IS" BASIS 
WIT! OUT WARRANTY. TIE AUTHOR ATD SELLIfr, DEALER SHALL HAVE K) 
LIABILITY OR RESPONSIBILITY TO CUSTOMER OR ANY OTHER PERSON Cft ENTITY 
WITH RESPECT TO ANY LIABILITY, LOSS OR DAMAGE CAUSED OP ALLEGED TO BE 
CAUSED DIPECTLY OR ItCIPECTLY BY THE "BOSS" COMPUTER PROGRAM, 
INCLUDING BUT NOT LIMITED TO ANY INTERRUPTION OF SERVICE, LOSS OF 
BUSINESS OR ArrnCIPATOPY rPCFITS OR CONSEQUEtrTIAL DAMAGES RESULTING 

rnai the ice of the "boss" program, the autior aid SELLitc dealer 

MAKE m CLAIM AS TO THE "BOSS" COMPUTER PROGRAMS FITMESS, SUITABILITY 
FOR A PARTICULAR USE, OR PERFORMANCE. 



"TRS-80" AND "TRSDOS" ARE REGISTERED TRADEMARKS OF RADIO SHACK, A 
TANDY CORPORATION. 
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1 - GENERAL ^FORMATION 



1.1 INTRODUCTION 



THIS UTILITY IS DESIGNED TO AID YOU IN CREATING AfD DEBUGGING 
PROGRAMS WRITTEN IN BASIC. THE UTILITY WILL AU£W YOU TO TRACE THE 
PROGRAM FLOW, TO SINGLE STEP THE BASIC PROGRAH, TO OBSERVE THE 
CONDITIONS OF VARIABLES DURING PROGRAM EXECUTION, AfD TO PUSH YOUR 
BASIC PROGRAMS ON THE STACK OR POP THEM OFF THE STACK DURIfC PROGRAM 
DEVELOPMENT. THE UTILITY IS KKMN TO OPERATE WITH ALL CURRENT DISK 
OPERATING SYSTEMS. 

THE UHLITY WILL OPERATE WITH EITHER LEVEL II BASIC OR DISK BASIC. 
THE MINIMUM EQUIPMENT CONFIGURATION IS A 16K, LEVEL II, S-80 UNIT 
WITH CASSETTE INPUT. TIE UHLITY IS UPWARDS COMPATIBLE WITH 32K AMD 
46K TAPE AMD DISC BASED S-80 SYSTEMS. 

1.2 BACKUP 



BEFORE YOU BEGIN, IT IS RECOMMENDED THAT YOU MAKE A BACKUP COPY OF 
THE UTILITY FOR YOUR PROTECTION. 

1.3 TRANSFERRING YOUR "BOSS" CASSETTE TO DISKETTE 

A. TAPEDISK/CMD 

PREPARE THE "BOSS* CASSETTE FOR LOADItC. 

UNDER "DOS READY" TYPE TATEDISK <ENTER> 

ANSWER THE "?" PROMPT WITH "C" -"EfTER> (LOADS "BOSS" INTO RAM) 

AFTER "DOSS" HAS BEEN LOADED, ANOTHER "?" WILL APPEAR 

TO SAVE "DOSS" OWT1 THE DISKETTE, ENTER THE FOtJ.fi/nCs 

?F BO5S/aD:0 6000 6R39 6070 <EtrTER> (MOTE: DRIVESPEC REQUIRED) 

?E < ENTER > 

tew "boss" is on Yam diskette for "dos ready" execution. 

B. LMOFTSET/CMD 

PREPARE THE "DOSS" CASSETTE FOR LOADIfC. 

UNDER "DOS READY" T/PE LMOFFSET <EtTER> 

ANSWER THE QUERIES AS FOLLOWS 1 

"SOURCE FROM DISK OR TAPE? REPLY "D" OR "T"?" T <ENTER> 

ATTCR A SUCCESSFUL LCWD, I/PTFSrT WILL RESPOND WITH THE LOAD 

ADDRESSES, THE EJTRY POINT, AMD TEIL YOU IT Wlti, OVERLAP THE 

"CMD" PROGRAM AREA. (NOTEl RELOCATION IS MDT NECESSARY) 

RESPOND TO "NEW LOAD BASE ADDRESS (HEX) ?" WITH 'ENTER> 

"DESTINATION FILESPEC?" BOSS/CM) <DrTER> 

IDH "BOSS" IS ON YOUR DISKETTE FOR "DOS READY" EXECUTION. 
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1.4 initializing tiie utility (disc systems) 

this utility is self-relocating aid does not have to reside in tiie 
highest byte of user ram available. load any other machiie lam1iage 
routines or utilities (ceded before you load aid initialize "boss* 
to initialize the utility from the "dos ready" mode, type "boss". do i 
try to "load" this utility. 

the utility mill l/v\d, execute amd respond with: 

"enter memory size (decimal) you wait to protect?" 

if you do hot want to protect any memdry other than that required for 
"doss", press "enter". if you have some other machine language code 
you want to protect, enter the lcwest decimal memory location which 
that code (not "boss") will occupy. "boss" will respond by telliig 
you what actual memory size to use to protect "doss" aid any other 
kacum5 language ccoe you asked to protect, if the other code has 
been loaded above "doss". 

note: users of trhdos 2.2 or later will have their program protected 
from the "64 byte bomb", upon "basic" or "basicr" initialization. 

example ii belcw shows initialization steps for a user who also has 
loaded a 1024 byte routine to pes ide in high memory of a 4pk machine. 

• dos ready 

• BOSS * 

• • 

• (THE SCREEN WILL CLEAR AID THE FOLLOWIIG TEXT APPEARS) * 

• ENTER MEMORY SIZE (DECIMAL) YOU WANT TO PROTECT? 64512 * 

• " 

• (THE SCREEN WILL CLEAR AID THE FOLLOWING TEXT APPEARS"' * 
» * 

• ANSWER THE MEMORY SIZE QUESTION WITH XXXXX ■ 

EXAMPLE 1 

THE UTILITY MOVES ITSELF TO MEJTDRY JUST BELOW THE MEMORY SIZE YOU 
ASKED TO PROTECT. 

AFTER "BOSS" HAS PFJ/CATED ITSELF, TYFE: 

(FOR TPSDOS) BASIC 

ANSWER THE FILES QUESTION AS NEEDED. 

ANSWER THE MEMORY SIZE QUESTION WITH XXXXX, WHERE XXXXX IS THE MEMORY 

SIZE WHICH "DOSS" HAS ASKED YOU TO USE. 

(FOR NEKDOS) BASIC F, XXXXX 

WHERE F- THE NUMBER OF FILE BUFFERS TO BE USED AID XXXXX ■ TOE 
MEMORY SIZE WHICH BOSS HAS ASKED YOU TO USE. AFTER THE SYSTEM GIVES 
YOU TIT READY PROMPT, THE FIRST LETTER KEY YOU PRESS WILL INITIALIZE 
THE UTILITY. YOU APE NOW READY TO ,USE THE FUNCTIONS DESCRIBED IN 
SECTIONS 2, 3, 4, OR 5. 
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1.5 INITIALIZING TIE UTILITY (CASSETTE SYSTEMS) 

AS WITH DISC BASED SYSTEMS, THE UTILITY IS SELF-RELOCATING AND DOES 
fDT HAVE TO RESIDE: IN THE HIGHEST BYTE OF USER RAM AVAILABLE. IF YOU 
HAVE ANY OTHER MACHINE LANGUAGE UTILITY OR DRIVER ROUTINES TO GO INTO 
HIGH MET DRY, ANSWER THE HEMORY SIZE QUESTION AS NORMALLY REQUIRED AND 
LOAD THE MACHINE LANGUAGE CODE BEFORE YOU LOAD AND INITIALIZE "BOSS". 
IF YOU DO NOT LOAD ANY OTHER MACHINE LANGUAGE CODE EXCEPT "BOSS", A 
SPECIFIC MEtORY SIZE REPLY IS NOT NEEDED. 

PREPARE THE "DOSS" CASSETTE FOR LOADING AID TYPE "SYSTEM". ANSWER THE 
"*?" PROMPT WITH "BOSS". AFTER A SUCCESSFUL LOAD (APPROXIMATELY 58 
SECONDS) ANOTHER "•?" WILL APPEAR. PRESS THE "/" AND "ENTER" KEYS. 
THE SCREEN WILL CLEAR AID THE FOLLOWING PROMPT WILL APPEARi 

ENTER MEMORY SIZE (DECIMAL) YOU WANT TO PROTECT? 

ENTER THE MEMORY SIZE USED TO PROTECT THE PREVIOUSLY LOADED MACHINE 
LANGUAGE CODE OR, IF "BOSS" WAS THE ONLY PROGRAM LOADED, PRESS 
"ENTER". "BOSS" WILL RESPCID WITH THE FOLLOWING MESSAGE: 

YOUR MEMORY SIZE IS XXXXX 

1.6 CONTROL KEY 



TC ENABLE YOU TO USE THE UTILITY A CONTROL KEY HAS BEEN DEVELOPED. 
THIS KEY IS THE "€" KEY AND WILL BE REFERRED TO AS <CON> IN THE 
REMAINING SECTIONS OF THIS DOCUMENTATION. THE "9" SYMBOL IS NOW A 
SHIFTED ZERO. REMEMBER, THE <CON> KEY IS JUST ABOVE THE "ENTER" KEY 
AND IS LABELED "9 m . 

tDTE: THE SHIFT "0" STILL CANNOT BE USED IN "PRINT?", YOU MUST USE 
THE SHIFT "0" KEY TO OBTAIN THE PROPER "8" SYMBOL. SHIFT "9* 
CONTINUES TO FUNCTION AS "PAUSE EXECUTION AND FREEZE DISPLAY". 
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2 - TRACING FUNCTION 



2.1 INIPODUCnON 

THIS UTILITY WILL ALLOW YOU TO FOLLOW TIE TWISTED (OR LOGICAL) PATH 
YOUR PROGRAM TAKES, WITHOUT THE MESSHESS ON THE SCREEN CAUSED BY 
SOME OTHER TRACE FUNCTIONS. THERE ARE THREE MAJOR TRACE COMMANDS. 

<CON> 1 - TRACE OFF 

<CON> 2 - TRACE ON TO VIDEO DISPLAY 

<CON> 3 - TRACE ON TO PRINTER 

2.2 TRACE OFF 

PRESSING "<CON> 1" WILL TURN OFF THE TRACE. WHEN THE UTILITY IS 
LINKED, IT WILL SLOW DOWN, PROGRAM EXECUTION. IF YOU WANT TO CHECK 
CRITICAL TIMING LOOPS YOU SHOULD TURN OFF TIE UTILITY AND UNLINK IT 
BY PRESSING "<CON> 1". THIS WILL ALLOW YOUR PROGRAM TO RUN AT NDRHAL 
SPEED. 

2.3 TRACE TO DISPLAY 



PRESSING "<CON> 2" WILL TURN ON TIE TRACE FUNCTION WD WILL DISPLAY 
EACH BASIC PROGRAM LIIE NUMBER, AS IT IS EXECUTED. THE LINE NUMBERS 
WILL BE DISPLAYED ON TIE TOP RIGHT AREA OF TIE SCREEN IN THE 
FOLLOWING FORMAT: 

50 

60 
30 
40 

TIE LAST FOUR LINE NUMBERS FXECUTED WILL PF, DISPLAYED. THE LINE 
NUMBER CURRENTLY BEING EXECUTED WILL BE PREFIXED BY TIE "-" SIGN. 
THIS AREA WILL NTT SCROLL AID WILL OVERPRINT ANYTHING DISFLAYED BY 
YOUR PROGRAM AS LONG AS TIE TRACE IS DIRECTED TO TIE SCREEN. 

2.4 TRACE TO TIE PRINTER 



PRESSING "<CON> 3" WILL TORN TIE TPACE FUNCTION ON AfD DIRECT TIE 
OUTPUT TC TIE PRINTER. ID TRACE INFORMATION WILL APFEAR ON TIE 
SCREEN. THE OUTPUT WILL LOOK SIMILAR TO THIS: 

10 20 30 50 60 1000 1010 1020 1030 70 

TRACING WILL CONTINUE TO THE PRIITER UNTIL TIE TRACE FUNCTION IS 
REDIRECTED TO TIE DISPLAY VIA "<CON> 2" OR TURNED OFF VIA "<CON> 1". 

TIE TPACE FUNCTION WILL SICW EACH LINE NUMBER AS THAT LINE IS ENTERED 
FOR EXECUTION. IF MULTIPLE STATEMEITr LUES ARE USED SUCH AS "100 FOR 
X=l TO 10: A(X)«3*Y: NEXT X ", TIE TPACE FUNCTION WILL DISPLAY LINE 
100 ONE THE, NOT TEN TUTS. CALLS, TO SUBROUTINES, GCTOS AID REMARK 
LINE NUMBERS WILL BE SI Off! AS ENCOUNTERD. 
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3 - SIMILE STEPPIIG 



3.1 irrcRODUcnoN 



THIS UTILITY WILL ALLOW YOU TO SINGLE STEP ^DIVIDUAL LINES OF A 
BASIC PROGRAM OR IIDIVIDUAL INSTRUCTIONS WITHIN A LINE. IN ADDITION, 
YOU CAN VARY THE DELAY IN WHICH YOUR PROGRAM STEPS BETWEEN LINES OR 
INDIVIDUAL INSTRUCTIONS. THERE ARE FOUR SINGLE STEP CGWWIDS. 

<CON> 4 - SIMXE STEP OFF 

<CON> 5 - SINGLE STEP TO END OF LINE 

<CON> 6 - SIMXE STEP INS TRUCT ION 

<CON> 7 • VARIABLE DELAY STEP 

3.2 SIMXE STEP OFF 

PRESSING "<CON> 4" WILL TURN OFF THE SIMXE STEP FUNCTION MB ALLOW 
YOUR PROGRAM TO RUN AS NORMAL. IF THE TRACE FUNCTION WAS IN USE, IT 
WILL CONTINUE TO FUNCTION UNTIL TURNED OFF. (SEE SECTION 2.2) 

3.3 SIMXE STEP TO END OF LINE 

PRESSING -<CON> 5" WILL CAUSE YOUR PPCGRAM TO PAUSE AT THE EM) OF 
EACH LIFE UNTIL THE SPACE BAR (OR ANY OTHER KEY) IS PRESSED. THE 
TRACE TO V1DED DISPLAY NODE WILL ALSO DE INITIATED TO SHOW YOU WHICH 
LINE NUMBER IS BEING EXECUTED. THIS TRACE MDDE CAN BE DISABLED BY A 
"<CON> 1", WHILE THE SIMXE STEP MODE WILL CONTINUE. 

3.4 SIMXE STEP INSTRUCTION 

PRESSING "<CON> 6" WILL CAUSE YOUR PROGRAM TO PAUSE WHEW AN 
INSTRUCTION SEPARATOR, :, IS FOUND AND AT THE END OF EACH LINE. 
PRESS THE SPACE-BAR (OR ANY OTHER KEY) TO CCWTIfU'E TO THE NEXT 
INSTRUCTION. AGAIN, THE TRACE TO VIDEO DISPLAY MODE WILL BE INVOKED 
TO SHOW YOU WHICH LINE NUMBER IS BEIN3 EXECUTED. THIS FUNCTION CAN BE 
USEFUL, BUT BE WARY OF USItG IT IF A PPCGRAM CONTAINS LItXS SUCH AS: 

TO FOR X=l TO 1C0:A(X)««+3*X*Z:NEXT X 

TO SINGLE STEP THTOUC-II THIS LOOP WOULD REQUIRE 300 PRESSES OF A KEY. 
INSTEAD USE "SINGLE STEP TO END OF LINE." 

3.5 VARIABLE DEL/9 STEP (AUTO STEP) 



PRESSING "<CON> 7" WILL CAUSE YOUR PROGRAM TO DELAY APPROXIMATELY 
0.25 SECONDS AT THE END OF EACH LUX. AGAIN THE TRACE TO VIDEO WILL 
BE INVOKED TO SHOW YOU WHICH LIIE MJMBER IS EEIfG EXECUTED. "<CON> 5" 
AID "<CON> 6" BECOME SUB-COMMANDS AFTER "<CON> 7" IS INITIATED. 
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PRESSING "<CON> 6" AFTER "<CCM> 7" IS INITIATED WILL CAUSE THE DEIAY 
TO OCCUR AT AN INSTRUCTION SEPARATOR, IN ADDITION TO THE Et.D OF A 
LIME. PRESSING "<CON> 5" WILL CAUSE THE DELAY TO OCCUR AT THE OH OF 
A LINE ONLY. THIS DELAY HAS MINE SETTINGS FROM APrRnXIfATELY 4 
MILLISECONDS TO APPROXIMATELY 0.9 SECONDS. TO SPEED UP EXECUTION 
(DECREASE DELAY) PRESS "<CON> ]". TO SLOW DOWN EXECUTION INCREASE 
DELAY) PRESS "<CON> l". THE AMOUNT OF DEJAY CAN BE ADJUSTED «« TIMF 
AFTER BOSS IS INITIALIZED IN BASIC. THE INITIAL SETTING PROVIDES 0.25 
SECONDS DELAY. THE AMOUNT OF DELAY IS HALVED EACH TINE "'CON) t" IS 
PRESSED, OR DOUBLED EACH TIME "<CCN> J" IS PRESSED. PUFIfG THIS 
DELAY, KEY PRESSES ARE tCT RFCCCT'IZED. 



4 - SETTI1G BREAK POINTS 



4.1 BREAK POINTS 



THE TRACE AND SINGLE STEP COMMANDS DESCRIBED IN SECTIONS 2 AID 3 CAN 
BE INVOKED BY YOUR PROGRAM WHILE IT IS RUNNING ' BY Il£EPTItC A POKE 
INSTRUCTION IN YOUR PROGRAM AT THE LOCATION WHERE YOU WANT TO INVOKE 
THE OCNMAND. THE FOLLOWING CODES ARE USED: 



FUTCTION 


POKE 


; 16667, 


TRACE OFF 




1 


TRACE TO DISTLAY 




2 


TRACE TO PRINTER 




3 


SINGLE STEP OFF 




4 


SINGLE STEP TO END OF LINE 




5 


SINGLE STEP INSTRUCTION 




6 


VARIABLE DELAY STEP 




7 


4.2 EXAMPLES OF BREAKPOINT USE 







IF YCG WANT NORMAL PROGRAM EXECUTION TO LINE 1540, 1HFN SINGLE 
STEPPIIC WI1V TRACE TO HIE SCREEN* INSERT JUST PRIOR TO LINE 15<C, 
TOE INSTRUCTION "POKE 16667,5". 

EXAMPLE 1 EXAMPLE 2 

1530 (USERS TEXT) 1530 (USERS TEXT) 

1535 POKE 16667,5 l c 40 PTKE 16667,5; (USERS TEXT) 
1540 (USERS TEXT) 

fCTEl IF YOUR PROGRAM LOGIC HAS COTO'S, COSUR'S, ETC., BE SURE TO 
POSITION THE BREAKPOINT WHERE THE CODE WILL BE EXECUTED. 

MTTIPLF POKES APE PERMITTED; POKE16667,7:pOKE16667,l : rCKF.166fi7,6 
THIS WILL INVOKE "VARIABLE DFIAY STEP" BETWEEN INSTRUCT IC*iS WITH THE 
TRACE DISABLED 

NOTE: YOU CAN INSERT AS l-MS BREAK POINTS IN Ya'R IVCGW AS Yfti 
DESIRE. 
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5 - REVIEWING VARIABLES 



GFJCTAL INFORMATION 



TIIS UTILITY WILL ALLOW YOU TO PAUSE TO REVIEW SELECTED VARIABLES 
DURIfC PROGRAM EXECUTTON MO THEN RETURN TO YCUR PROGRAM WITH THE 
DISPLAY RESTORED TO THAT SHOWN BEFORE YOU REVIEWED THE VARIABLES. 
THERE ARE TOO CO HANDS USED FOR THIS FUNCTION. 

<CON> N - SELECT VARIABLES FOR REVIEW 
<CCN> ■ REVIEW THE SELECTED VARIABLES 

5.2 SELECTING VARIABLES 

PRESSING "<CON> M" WILL ALLOW YOU TO SELECT THE VARIABLES YOU WANT TO 
REVIEW DURING PROGRAM EXECUTION. THIS COM1AND CAN BE OTTERED AT AW 
TIME BEFORE YOU PUN THE PROGRAM OR DUTJfC PROGRAM EXECUTION. 

AFTER INVOKING "<CON> N", THE QUERY 'ENTER MAXIUJM VARIABLE LEHHH?" 
WILL BE DISPLAYED. RESPOND FROM THE FOLLOWING CHOICES: 

RESPONSE RESULT 



BREAK EXIT FUNCTION t RETURN TO BASIC PROGRAM 

1 1 CHARACTER VARIABLE NAH5 

2 CR 3 MAXIMUM OF 3 CHARACTER VARIABLE tA/TES 
4-7 MAXIfUN OF 7 GIAPACTER VARIABLE NAMES 
8-15 NAXIUJM CF 15 CHARACTER VAPIAELE NAMES 
16 - 31 MAXIMUM OF 31 CHARACTER VARIA BLE NAMES 
ENTER DEFAULT TO MAXIftlM OF 7 CHARACTER NAMES 

THE MAXIMUM NUMBER OF VARIABLES FOP REVIEW IS LIMITED BY THE MAXIMUM 
VARIABLE NAME LENGTH SELECTED* AS SICWN EELOW. 



NAME LENGTH 


HJMBER OF VARIABLES TO REVIEW 


1 


MAXIMUM CF 129 


2-3 


MAXIMUM OF 64 


4-7 


MAX I r I'M OF 32 


8-15 


MAXIUJM OF 16 


16-31 


MAXIMUM CF 8 



M7TE: TFE NAME LENGTH INCLUDES ALL CHARACTERS. THE VARIABLE NAME 
AS(21,5) IS CONSIDERED TO HAVE A LENGTH OF EIGHT (8), F(R(3,8>) IS 
HtNE aiARACTERS IN LENGTH. 
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AFTER SUCCESSFULLY ENTER1H3 A VARIABLE LUPni, THE MESSAGE "INPUT 
VARIABLES FOR REVIEW, "BREAK" TOtfilNATES FUNCTION" WILL BE DISPLAYED 
AND ALL PREVIOUSLY ENTERED VARIABLE CHOICES WIIA, BE ERASED. THIS 
FUNCTION WILL ALLOW YOU TO ENTER VARIABLES USING THE FOUOWIIC 
SYNTAX: 

A Xi Bl QMFfG.Q)) 

KS AI(F(G,Q)> F<2,3> Tt (F, (R(A,N) , <G<E) > ) 

A<B) WEEKDAY S» A(B,C) 

(ETC.) 

ANY NUMBER OF PARFJ7I1IESES ARE ALLOWED, PROVIDED YOU CLOSE THEM WITHIN 
THE VARIABLE LENGTH ENTERED. ALTHOUGH ILLEGAL VARIABLE NAMES SUCH AS 
A$3 OR A(3H) ARE NOT REJECTED, THEY WILL CAUSE ERPOPS LATER WHEN 
REVIEW OF THE VARIABLES IS ATTEMPTED. 

WHQJ YOU HAVE FINISHED ENTERING THE VARIABLES, PRESS "BREAK" TO 
CONTINUE WITH THE REVIEW* IF YOU BTTHX THE fAXIHJM NUMBER OF 
VARIABLES ALLOWED, "BOSS" WILL AUTOMATICALLY PROCEED WITH THE PEVIEW. 
AT THIS POINT "BOSS" INVOKES A "<CON> 0" AS DESCRIBED IN SECTION 5.3 
BELOW. 

5.3 DISPLAY VARIABLES 



PRESSING "<CON> 0" AT ANY TIME DURING PROGRAM EXECUTION WILL 
ir?1EDLATELY SAVE THE CONTEffTS OF THE VIDEO DISPLAY AND REPLACE IT 
WITH THE MESSAGE "VARIABLES -PRESS "C" (CHANGE), "BPEAK" (BB), 
OTHERS ADVATCE" WILL APPEAR ALONG WITH THE FIRST VAPIABLE AND ITS 
VALUE. VARIABLES ARE DISPLAYED IN THE ORDER ENTERED BY THE "<CON> N* 
FUNCTION. 

PRESSING "BREAK" WILL CAUSE THE MESSAGE "OO - *FR£SS "BREAK" TO 
RETURN, OTHERS TO REVIEW AGAIN" TO APPEAR. IF YOU ARE REALLY EINXSHED 
WITH THE VARIABLE REVIEW, PRESS "BREAK" AGAIN AND YOUR ORIGINAL V1PFO 
DISPLAY WILL BE RETURNED. YOUR PROGRAM WILL RESUME EXECUTION* AT THAT 
POINT. IF YOU INSTEAD WANT TO REVIFW MDPE VARIABLES, PRESS AW KEY 
OTHER THAN "BREAK". PRESSING "C" WILL ALLOW YOJ TO SELECT ANOTHER 
VARIABLE IN PLACE OF THE lA'T VARIABLE DISPLAYED. THE NEW VARIABLE 
SELECTED AND ITS VALUE WILL BE DISPLAYED. REMEMBER, THE VARIABLE NAME 
IS LIMITED IN LFMGTH PER YOUR ORIGINAI, CHOICE WHEN "<CON> N" WAS 
SELECTED. 

PRESSING ANY KEY OTHER THAN "BREAK" OR "C" WILL ADVAICE WE PISnJVY 
TO THE NEXT VAPIABLE SELECTED. IF Yd.' ATTEMPT TO REVIEW A VAT I AT IF. 
WHOSE SUBSCRIPT IS OUT OF PAIGE OP Willi AN ILLEGAL NAME, THE MESSAGE 
"ERROR, PE-FirTER" WILL BE DISPLAYED AID THE "C" COMMAND WILL 
AUTOMATICALLY PE INVOKED. YOU MUST SELECT A VALID VARIABLE TO EXIT 
FROM THIS SUB-COMMAND. IF YOU EVALUATE AN ELEMENT OF AN APFAY 
(SUBSCRIPT < 11) AID THE ARRAY HAS NOT YET PFFN DlfJENSlOHED BY YOUR 
PROGRAM, THIS ARRAY WILL BE DIMENSIONED FOR ELEVEN ELEMENTS (0-10). 
IF YOUR PROGRAM SUBSEQUENTLY ATTEMPTS TO DIMENSION THIS APRAY VIA THE 
"DIM" INSTRUCTION, AN ERROR WILL CCCUR. DIMENSION ALL USED ARRAYS 
BEFORE YOU REVIEW THEM WITH THE REVIFW VARIABLES FUNCTION. 
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6 - stacking programs 



6.1 GENERAL INFORMATION 



TIIIS imLITY WILL ALLOW YOU TO STACK ONE OR MORE PROGRAMS IN HIGH 
MEMORY WHILE YOU WORK ON OR RUN ANOTHER PROGRAM. OF COURSE, THIS 
ABILITY IS LIMITED BY THE AMOUNT OF FREE MEMORY SPACE AVAILABLE. YOU 
CAN RETRIEVE THE STACKED rROGRAM(S) AT WILL. THE INTERRUPTS ARE 
DISABLED IN ORDER FOR THIS FUNCTION TO OPERATE PROPERLY. IN ADDITION 
THIS FUNCTION INVOKES A "CLEAR 50" UPON COMPLETION. THERE ARE FIVE 
MAJOR COMMANDS FOR THIS FUNCTION. 

<OON> - • SAVE THE BASIC PROGRAM IN HIGH MEMORY (PUSH) 
<CON> : • RECALL THE LAST SAVED PROGRAM FROM MEMORY (POP) 
<CON> 8 - APPEND THE LAST SAVED PROGRAM TO THE 

CURRENT PROGRAM 
<OON> 9 - APPEND THE NEXT TO LAST SAVED PROGRAM TO 

THE CURRENT PROGRAM 
<OON> • RECALL THE NEXT TO LAST SAVED PROGRAM (SWITCH) 

6.2 PUSHING PROGRAMS 



PRESSING "<CON> -* WILL "SAVE" THE RESIDENT PROGRAM IN HIGH MEMORY 
USING THE "MEMORY SIZE" PREVIOUSLY ENTERED AS TOE END AND WILL 
AUTOMATICALLY AaTUST "MEMORY SIZE" TO TOE BEGINNirG OF THE OF THE 
PUSHED PROGRAM, THUS PROTECTING IT FROM BASIC. YOUR CURRENT PROGRAM 
WILL ALSO BE LEFT AVAILABLE IN BASIC RAM, IF MEMORY PERMITS. SINCE 
MEtCRY SIZE IS ADJUSTED, SUBSEQUENT PUSHES CAN BE MADE AS DESIRED. 

WHEN A PROGRAM IS PUSHED, A GRAPHIC VERTICAL BAR WILL APPEAR IN THE 
UPPER RIGHT CORNER OF THE VTDFD DISPLAY. THIS BAR INDICATES THAT A 
PROGRAM HAS BEEN PUSHED INTO HIGH MEMORY AM) A PROGRAM IS IN BASIC 
MEMORY FOR USER EXECUTION OR MODIFICATION. IF INSUFFICIENT MEMORY IS 
AVAILABLE TO PUSH YOUR PROGRAM AND ALSO MAINTAIN IT IN BASIC RAM 
(I.E. TRYING TO PUSH A 30K PROGRAM IN A 48K MACHINE), YOUR PROGRAM 
WILL BE PUSHED AND A "NEW" INVOKED. THIS CONDITION WILL BE INDICATED 
BY A CLEAR SCREEN WITH A SMALL GRAFHIC BLOCK IN TOE UPPER RIQrr OF 
THE VIDEO DISPLAY. 

6.3 POPPING PROGRAMS 



PRESSING "<CCN> l" WILL POP OR RETRIEVE TOE LAST SAVED PROGRAM FROM 
HIGH MEMORY. THE RESIDENT PROGRAM WILL BE LOST. MEMORY SIZE WILL 
AUTOMATICALLY BE ADJUSTED. IF NO SAVED PROGRAM REMAINS, THE ERROR 
MESSAGE "NOTHING TO POP" WILL BE DISPLAYED. 
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6.4 SWITCHING PROGRAMS 

PRESSING "<CON> 0" WILL RETRIEVE "HIE NEXT TO LAST SAVED PROGRAM FROM 
HIGH MEMORY. TIIE RESIDENT PROGRAM WILL BE LOST. IF YOU WANT TO SWITCH 
THE RESIDENT PROGRAM WITH THE LAST SAVED PROGRAM FIRST PUSH THE 
CURRENT PROGRAM VIA THE "<CON> -" COMMAND WO THEN RETRIEVE THE NEXT 
TO LAST PROGRAM VIA THE "<CCN> 0" COMMAND. 

6.5 APPENDING PROGRAMS 



FRESSING "<CON> 8" WILL RETRIEVE TilE LAST SAVED PROGRAM AND APPEND IT 
TO THE RESIDENT PROGRAM. 



PRESSING "<CON> 9" WILL RETRIEVE THE 
APPEND IT TO THE RESIDENT PROGRAM. 



H3CT TO LAST SAVED PROGRAM AND 



EXAMPLES OF MEMORY CONTENTS 



BEFORE 


AFTER 


w BEFORE 


AFTER 


<CON> 8 


<CON> 8 


<O0N> 9 


<CCH> 9 


UTILITIES 


UTILITIES 


UTILITIES 


irriLiTTES 


PROG 1 


FREE RAM 


PROG 1 


PROG 2 


FREE RAM 


FREE RAM 


PROG 2 


FREE RAM 


FREE RAM 


PROG 1 


FREE RAM 


PROG 1 


PROG 2 


PROG 2 


PROG 3 


PROG 3 



LINE NUTBER SEQUENCE IS MANDATORY FOR PROPER EXECUTTCW OF 311E 
APPENDING COMMANDS. THE STACKED PROGRAM SWULD HAVE ITS LCMEST LINE 
NUMBER GREATER THAU THE HIGHEST LINE NUMBER IN THE CURRENT PROGRAM IN 
BASIC RAM. THESE COMMANDS APFEND, TJIEY DO NTT MERGE. 

NOTE: THE "PUSHED" ITEM CAN BE AS LITTLE AS ONE PROGRAM LINE. THIS 
MAKES THIS FUNCTION USEFUL TO APPEND/INSERT A FAVORITE RCVI7NE INTO 
SEVERAL PROGRAMS. 
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7.1 NOTES 



IF A "LINE" PRINTER IS BEING USED, THE TRACE INFORMATION WILL SEW 
THE COMPLETE PROGRAM FLOW, DUT WILL ONLY BE PRINTED WHEN AN ENTIRE 
PRINT LINE IS AVAILABLE. THIS IS BECAUSE THE PRINTER WILL NOT OUTPUT 
ANY DATA UNTIL A COMPLETE PRINT LINE IS SENT. IF A CHARACTER AT A 
TINE, PRINTER IS BEING USED, THE TRACE INFORMATION WILL BE PRINTED AS 
EACH PROGRAM LINE NUMBER IS EXECUTED. 

THE PRINT FORMAT FOR A TRACE TO PRINTER IS SPACE, 10K DIGIT, IK 
DIGIT, 100'S DIGIT, 10'S DIGIT, AND UNIT DIGIT. ZERO SUPRESSION IS 
USED AND EACH LINE REQUIRES SIX CHARACTER POSITIONS. THIS FITS IN 
WELL WITH 72 CHARACTER PER LINE (12 LINE TRACES) AH) 132 CHARACTER 
PER LINE (22 LINE TRACES) PRINTERS. THIS OUTPUT CAN BE CONTROLLED BY 
ANY TYPE OF USER LINKUP TO THE PRINTER DEVICE CONTROL BLOCK, SINCE IT 
IS R/W SPACE/NUMERIC OUTPUT. NO LIICFEEDS, CARRIAGE RETURNS, OR 
CONTROL CHARACTERS ARE SENT. 

7.2 THINGS YOU SHOULD KNOW 



A. THIS UTILITY DEFEATS THE BUILT-IN TRACE FUNCTION. 

B. THIS UTILITY LINKS TO THE KEYBOARD CONTROL, BLOCK 
AT© INCORPORATES ANY KEYBOARD ROUTINE PRESENT WHEN 
"BOSS" IS INITIALIZED (I.E. KEYBOARD DENOUNCE ROUTINE). 

C. THIS UTILITY LINKS TO THE VIDEO CONTROL BLOCK AfC 
INCORPORATES ANY ROUTINE PRESENT WHEN "BOSS" IS 
INITIALIZED. 

D. REBOOTS WILL NTT RECOVER THE UTILITY. DOS USERS 
USE OF "BASIC •" WILL HOT RECOVER THE UTILITY. 

E. BREAK POINTS ARE INVOKED AFTER THE BREAKPOINT 
INSTRUCTION IS EXECUTED. 

F. "BOSS" DOES tOT INTERFERE WITH ANY UTILITIES WHICH 
LOAD BF3CW BASIC. 

G. YOU CAN RESERVE ADDITIONAL MEMORY BY USIfG AN AP- 
PROPRIATE NUMBER LESS THAN THAT WHICH "BOSS" ASKED 
YOU TO USE, OR YOU CAN START BOSS AT A LOWER 
LOCATION AS YOU SEE FIT. 

H. USERS OF TRSDOS VERSIONS 2.2 OR LATER MAY USE THE 
"ENTER" COMMAND IN PLACE OF A SPECIFIC MEMORY SIZE 
IF "BOSS" IS LOADED LAST. USERS OF NEWDOS EDITION 
05/29/79 (ZAP 013) OR LATER CAN ALSO USE THE "ENTER" 
COMMAND. 



ORIGINAL DOCUMENTATION WRITTEN BY C. A. P. THOMAS 
VERSION 2.1 ADDITIONS BY V. B. HESTER 
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